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This document is an introductory manual for tlie RT-11 operating 
system. Its purpose is to acquaint new users with the RT-11 
commands that perform common system operations. This manual 
presents the background material necessary to understand the system 
operations. It also contains a series of command examples and 
demonstration exercises that complement the text. 
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Creating and Editing Text Files 



The K (Kill) command erases the entire line following the pointer 
and positions the pointer at the beginning of the next line in the 
text. Type: 



# K |sc) L |sc) (Sc) 
AR ENDOWED 



BY THEIR CREATOR » THAT AMONG 



The pointer is now at the beginning of the next line in the text. As 
you can see, this line also contains an error, the word ARE is 
incorrectly spelled as AR. Use the J command to jump over two 
characters, and insert the E. Then verify the line: 

# 2 J (ESC) I E fsc) y He) dig 

ARE ENDOWED BY THEIR CREATOR* THAT AMONG 

* t 

The arrow shows where the pointer is now positioned. This line 
still contains an error — it is missing the words WITH CER- 
TAIN INALIENABLE RIGHTS, which should follow the word 
CREATOR. You can count the number of characters from the 
pointer to the second R in CREATOR and then jump the pointer 
by this number, or you can use the G (Get) command. The G 
command searches, from the pointer, for the first occurrence of a 
specified character string and leaves the pointer at the end of that 
string. Use the G command to search for the string OR (in CREA- 
TOR); then insert the missing words and list the lines that have 
changed. Notice how you use the carriage return to break the line 
into two parts (the ® symbol is used to show where you should 
insert spaces): 

^GOREsglCsD WITH@CERTAIN@iB 

INALIENABLEia R I G H T S lie) - A HQ) 2 L |sc) |sc) 

ARE ENDOWED BY THEIR CREATOR WITH CERTAIN 

INALIENABLE RIGHTS* THAT AMONG 
* 

To list both lines, it was necessary to move the pointer back to the 
beginning of the first line you changed; this was done by the -A 
command. The 2L command then listed both lines. Notice where 
the pointer is; it was moved by the -A command and was not 
repositioned by the L command. 

You must be careful when you use the Get command, because the 
character string you specify must be unique if you want the 
pointer to move to the correct spot. For example, if the characters 
OR had occurred anywhere after the pointer and before the word 
CREATOR, the pointer would have stopped there instead, and 
you would have inserted text in the wrong pdace. 

The final errors in this text occur in the last line. The words THE 
PURSUIT OF are missing, and the word HAPLENESS is a mis- 
spelling. Use the Get command to move the pointer to the word 



GET 
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Creating and Editing Text Files 



AND and insert the missing text. Move the pointer again with the 
Get command to the PLE of HAPLENESS; erase the LE, and 
insert PI. Then verify the line: 



*GANDfsc)I(lP)THE(iP) PURSU I T@ OFUgdc) 

* G P L E fsc) - 2 D (ESC) I P I |sg 1.1 (ES§ He) 

THESE ARE LIFE* LIBERTY AND THE 



PURSUIT OF HAPPINESS. 



CTRL/L 



Large text files of 50 lines or more should be delimited into pages. 
To do this, insert a form feed into the text at the place wherei you 
want the page to end. A form feed is typed as a CTRL/L (hold the 
CTRL key down and type the L key), which the editor recognizes 
as a page break. 

Since this text file is only five lines long, there is really no need to 
delimit it as a page. However, for the sake of practice, insert a 
form feed at the end of this file. Then move the pointer to the 
beginning of the text buffer and list the entire text. Compare your 
text with the following example. If errors remain in your file, fix 
them by using the commands described so far. 



*G.iSC)I(lT) 



(CTRL/L echoes as eight line feeds.) 



dE) B (ESC) / L HI) (ESC) 

WE HOLD THESE TRUTHS TO BE SELF-EU IDENT , 

THAT ALL MEN ARE CREATED EQUAL » THAT THEY 

ARE ENDOWED BY THEIR CREATOR WITH CERTAIN 

INALIENABLE RIGHTS, THAT AMONG 

THESE ARE LIFE, LIBERTY AND THE PURSUIT OF HAPPINESS. 



This text is correct in spelling and content, but the last two lines 
should be justified to make them easier to read. The pointer is 
currently at the beginning of the text. Use the G command to 
search for the character string AMONG; then insert and delete 
text to justify the lines. Finally, list the text again: 



♦GAMONGisgKsg THESE® AREIDAllcjIODdcjB He)/ Ldc) (ESC) 
WE HOLD THESE TRUTHS TO BE SELF-EUIDENT , 
THAT ALL MEN ARE CREATED EQUAL, THAT THEY 
ARE ENDOWED BY THEIR CREATOR WITH CERTAIN 
INALIENABLE RIGHTS, THAT AMONG THESE ARE 
LIFE, LIBERTY AND THE PURSUIT OF HAPPINESS. 
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Creating and Editing Text Files 



Following are two demonstration programs. One is written in the 
FORTRAN IV programming language and one is written in the 
MACRO-11 assembly language. Both programs are used in later 
chapters of this manual, and both contain intentional misspell- 
ings and errors. 

Use the editor to create these programs. Type them exactly as 
they are shown, including errors. Use tabs and spaces to format 
each line as shown (remember that tab stops are positioned every 
eight spaces across the terminal page). Make sure that the FOR- 
TRAN program is formatted properly so that a source comparison 
described in the next chapter will operate properly. Except for the 
comment lines (those beginning with a C), begin all lines with a 
tab. Use any of the editing commands described in this chapter. 
Activate the display editor and immediate mode if you wish. 

When you have finished, check each file carefully. The two files 
should match those shown here exactly, including tabs and 
spaces. Correct any errors that you find that are not intentional. 
Obtain a listing of each file by using B Iscl/L (esc) He) before closing 
the file. 

Create the FORTRAN file first. Call it GRAPH.FOR and use the 
system volume for storage. Then create the MACRO program. 
Call it SUM. MAC and again use the system volume for storage. 

NOTE 

Knowledge of the FORTRAN IV and MACRO-11 
languages is not necessary to create these denn- 
onstratlon programs. 

The following program, GRAPH.FOR, is the FORTRAN demon- 
stration program. 

C GRAPH.FOR VERSION 1 

C THIS PROGRAM PRODUCES A PLOT ON THE TERHINAL 

C OF AN EXTERNAL FUNCTION, FUN(X.Y) 

C THE LIMITS OF THE PLOT ARE DETERMINED BY THE DAT.fl STATEMENTS 

C "STAB" IS FILLED WITH A TABLE OF WEIGHT FLAGS 

C 'STRING' IS USED TO BUILD A LINE OF GRAPH FOR PRINTING 

SCAL(ZMIN,ZMAX,MAXZ,K)=ZMIN+FLOAT(K-l)»(ZMl«-ZMIN) /FLOAT <MAXZ-1) 

LOGICAL*! STRING (13, 3) f STAB (100) 

DATA XMIN,XMAXrMAXX/-5,5f45/ 

DATA YMINrYMAXrMAXY/-5.5,72/ 

DATA FMIN.FMAX/O.Orl .0/ 

CALL SCOPYC- 1234S6789 +',STAB) 

MAXFLEN(STAB) 

no 20 IX=liiMAXX 

X=SCAL(XMIN,XMAX,MAXX,IX) 

CALL REPEAT( '«', STRING, MAXY) 

IFdX.EQ.l .OR. IX.EQ.MAXX) GOTO 20 
DO 10 IY=2,MAXY-1 

Y=SCAL(YMIN,YMAX,MAXY,IY) 

IFUN = 2+INT(FL0AT(MAXF-3)«(FUN()!,Y)-FMIN)/(FMAX-FMIN)) 
10 STRING(IY>=STAB(MINO(MAXF,MAXOl 1,IFUN))) 

30 CALL PUTSTRING(7, STRING,' ') 

CALL EXIT 

END 



CREATING THE 

DEMONSTRATION 

PROGRAMS 



FUNCTION FUN(X,Y) 

R=SQRT(X**2fY«*2) 

FUN=X*Y*R*EXP(-R) )*«2 

RETURN 

END 
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Creating and Editing Text Files 



The following program, SUM.MAC, is the MACRO demonstra- 
tion program. 



.TITLE SUM.MAC VERSION 1 
.MCALL .TTYOUTf .EXITj .PRINT 



70. 



5N0. OF DIGITS OF 



TO CALCULATE 



'E' 
1/0! 



= THE SUM OF THE RECIPROCALS OF THE FACTORIALS 
+ 1/1! + 1/2! + 1/3! + 1/4! + 1/5! + ... 



EXP: 



first; 
second; 



third: 



fourth; 



.PRINT 
MO!^ 

Moy 

MOV 
ASL 
MOV 
ASL 
ASL 
ADD 
DEC 
BNE 
MOV 
MOV 
MOV 
INC 
SUB 
BCC 
ADD 
MOV 

ADD 



DEC 

BNE 

MOV 

fifth: SUB 



BCC 

ADD 

.TTYON 

CLR 

DEC 

BNE 

.EXIT 



tMESSAG 

*N»R5 

♦N+lfRO 

*ArRl 

eRl 

I?R1.-<SP) 

SRI 

BRl 

(SP)+r (Rl)+ 

RO 

2ND 

♦ NfRO 
■-(Rl) .R3 
*-l»R2 
R2 

R0fR3 
FOURTH 
R0»R3 
R3f(>Rl 

R2-2(R1 ) 

RO 

THIRD 
-(Rl) »R0 

♦ 10. »R0 

FIFTH 
*10+'0.R0 

eRl 

R5 

FIRST 



PRINT INTRODUCTORY TEXT 

NO. OF CHARS OF 'E' TO PFlINT 

NO. OF DIGITS OF ACCURACY 

ADDRESS OF DIGIT VECTOR 

DO MULTIPLY BY 10 (DECIMAL) 

SAVE *2 

*4 

NOU *10. POINT TO NEXT DIIGIT 

AT END OF DIGITS? 

BRANCH IF NOT 

60 THRU ALL PLACES» DIVIDING 

BY THE PLACES INDEX 

INIT QUOTIENT REGISTER 

BUMP QUOTIENT 

SUBlRAtT LOOP ISN'T BAD 

NUMERATOR IS ALWAYS < lO^tN 

FIX REMAINDER 

SAVE REMAINDER AS BASIS 

FOR NEXT DIGIT 

GREATEST INTEGER CARRIES 

TO GIVE DIGIT 

AT END OF DIGIT VECTOR'? 

BRANCH IF NOT 

GET DIGIT TO OUTPUT 

FIX THE 2.7 TO .7 SO 

THAT IT IS ONLY 1 DIGIT 

(REALLY DIVIDE BY 10) 

MAKE DIGIT ASC II 

OUTPUT THE DIGIT 

CLEAR NEXT DIGIT LOCATION 

MORE DIGITS TO PRINT? 

BRANCH IF YES 

UE ARE DONE 



exp: 



.REPT N+1 
.UORD 1 
.ENDR 



i INIT VECTOR TO ALL ONES 



MESSAG; .ASCII /THE VALUE OF E ISW <15><12> /2./ <200> 
.EVEN 

.ENDEXP 
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Running a FORTRAN IV Program 



To link the example FORTRAN program, you must include 
FORLIB.OBJ in SYSLIB. For instructions on how to include 
FORLIB in SYSLIB, refer to Section 3.4 in the RT-11 FORTRAN 
IV Installation Guide. 



9-2.1 March 1981 



Running a FORTRAN IV Program 



point to look at the listing produced by the compiler, because 
more information is shown there. Print the listing on either the 
line printer or terminal, using one of the following commands: 



Long Command Format 

(Line printer) 

* PRINT m 

Files? GRAPH. LST m 



(Terminal) 

..TYPE m 

Files? GRAPH, LST®) 



Short Command Format 

(Line printer) (Terminal) 

. PRINT GRAPH. LST ®) .TYPE GRAPH. LST m 

Your listing should look like the following example. 

NOTE 

You do not need to understand the FORTRAN IV 
language or the way this program works to suc- 
cessfully complete the exercises in this chapter. 



FORTRAN IV 



yo2.i-io Thij u-Dec-uo oi:ih;50 



PAGE 001 



0001 
0002 
0003 
0004 
0005 
OOOi 

ooo; 

OOOS 
0009 
0010 
0011 
0013 
0014 
0015 
0016 
0017 
0018 
0019 

FORTRAN IV 



C ORAPH.FOR (VERSION FROVUiEIU 

C THIS PROGRAM PRODUCES A PLOT ON IHE TERMINAL. 

C OF AN EXTERNAL FUNCTION, FUN(X,Y) 

C THE LIMITS OF THE PLOT ARE HETERMINED BY IHE IiAlA STATEMENTS 

C -STAB' IS FILLEB WITH A TABLE OF HEIGHT FLACiS 

C -STRING- IS USED TO BUILD A LINE Oh GRAPH fOR PRINTING 

SCAL<ZMIiNfZMAXiMAXZrK)=ZMlN + FL0A1<K-l)»<ZMAX-ZMlN)/FL0AT(MAXZ-lJ 

LOGICAL*! STRING(13.3)>STAB<100) 

DATA XMIN,XMAX,MAXX/-5,5,45/ 



10 
30 



DATA YMIN,rMAXiMAXr/-5i5r 72/ 

DATA FMINrFMAX/O.Oil.O/ 

CALL SCOPYC- 1 2 3 4 5 6 7 8 9 +■ r STAB) 

MAXF=LEN(STAH; 

DO 20 IX=1>MAXX 

X=SCAL<XMIN,XMAXrMAXX,IX) 
CALL REPEAT( '*' iSTRINGiMAXY) 
IFdX.EQ.l .OR, IX.EQ.MAXX) GOTO 20 
DO 10 IY=2,MAXY-1 

Y = 8CAL(YMINtYMAX,MAXY ,!•! I 

:[FUN = 2+INT(FL0AT(rtAXF-3)*<FUN(X,Y)-FNIN)/<FMAX-FMIN) ) 
i5TRING<IY)=STAB(MIN0(nAXF,MAX0(l,lfUN)); 
CALL PUTSTR<7,STRINGr ' ') 
CALL EXIT 
END 



In line 0003. 

In line 0004, 

In line 0008, 

In line 0012, 

In line 0016, 

FORTRAN IV 



Diaanostics for Proaram Unit .MAIN. 

Error: Modes of variable "XMIN" snd data item diftef 

Error: Mode; of variable "YMIN- and data item differ 

Error: Reference to undefined itaternent label 

Error: Reference to i.indefined stateiTient label 

Error; kirons number of subscripts fur array -STRING" 

StoTci^e Map for Program Unit .MAIN, 



Local Variables, ,PSECT tDAlA, Size 



110, wards? 



Name 

FMAX 

IX 

MAXF 

MAXZ 



Type 

R*4 

1*2 

1*2 

1*2 



Offset 
000230 
000274 
000260 
000254 



Name 

FMIN 

lY 

MAXX 

MAXO 



Type 

R*4 

1*2 

1*2 
1*2 



Offset 
000224 
000300 
000272 
000316 



Name 
IF UN 
K 

MAXY 
MINO 



Type 
1*2 
1*2 
1*2 
1 .* 2 



Offset 
00031 i 
0002S6 
0002/0 
000314 
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Running a FORTRAN IV Program 



X 


R*4 


000262 


UMAX 


R*1 


00026O 


xrllM 


R.«1 


00021 'I 


Y 


R*1 


000302 


tMAX 


R*4 


000306 


r rt I fj 


RH 


000220 


ZMAX 


R»4 


000250 


ZMIN 


R*4 


000:'l<i 









Local and COMMON Arraasi 

Name T«pe Section Offset Sije lumensions 

STAB L*l »DATA 000017 000144 ( SO./ (100) 
STRING L*l Vec $DATA 000000 000047 < 20.) <13i3) 

Subroutinesi Functxonsi Statement smd Processor-Defined Functions! 



Name Tupe 


Name Tupe Name Tupe Name T^pe 


Name 


Type 


EXIT 


R»4 


FLOAT R*4 FUN R»4 INT 1*2 


LEN 


1*2 


PUTSTR 


R»4 


REPEAT R»4 SCAL R*4 SCOPY R*4 






FORTRAN 


IV 


V02.1-10 Thu ll-Bec-80 01!1S!5S 




PAGE 001 


0001 




FUNCTION FUN(X,Y) 






0002 




R=SQRT(X**2+Y»*2) 






0003 




FUN=X«Y*R*EXP(-R) )**2 






**»*» P 










0004 




RETURN 






0005 




END 






FORTRAN 


IV 


Diaanostics for Proaram Unit FUN 






In line 


0003» Error! CSee source listing] 






FORTRAN 


IV 


StorsSe Map for Proaram Unit FUN 







Local Variables^ .PSECT tDATAi Size -■ 000020 l 8. words) 

Name Tape Offset Name Tape Offset Name Tape Offset 
FUN R*4 000004 Env R R*4 000010 X R*4 6 000000 
Y R*4 e 000002 

Subroutines* Functiorisj Statement and Processor-Defined Functions! 

Name Tape Name Tape Name Tape Name Tape Name lypp 
SORT R*4 

The first part of the Usting shows the main program unit; and 
consists of the language statements up to, but not including, the 
function. This is followed by a diagnostics list, then by a storage 
map. Next the language statements comprising the function pro- 
gram unit are listed, again followed by a diagnostics list and a 
storage map. 

Before considering the individual sections of the program listing, 
first examine the program logic to determine what this program 
should do. The first few lines of this program are user comment 
lines that briefly describe the program. Essentially, this program 
produces on the terminal a graph of a "three-dimensional" func- 
tion, FUN(X, Y). The graph is plotted using 45 lines down and 72 
characters across the terminal page. The limits of the X and Y 
axes are +5 and -5. The third dimension, height, is a real number 
within the range to 1 and is represented in the listing as a 
number within a scale of 1 to 9. These dimensions are illustrated 
in Figure 9-3. 

The SCAL function determines the value of the next coordinate 
on the graph. The statements within the DO loops calculate the 
coordinates using the SCAL function and determine the height 
value. This is done for an entire line of coordinates across the 
terminal page. The entire line is then printed on the terminal, 
using the CALL PUTSTR statement; the number 7 in this state- 
ment is the FORTRAN method of naming the terminal as the 
output device. This procedure is repeated until all 45 lines of the 
graph have been printed. 
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Debugging a User Program 



rately with artificial data. After you test all parts individually, 
you can test routine and module linkage — system testing — to 
see that all related code fits together properly. 

Check the program with test data. A standard method for check- 
ing out modules is to write a test program that calls the program 
with possible options. The test should cause the program to exe- 
cute all steps in all algorithms. Check programs first with repre- 
sentative data, then with improper data (data that is not in the 
correct range or size). You should also do volume testing to see 
that the program works successfully with a representative amount 
of data. 

Each programming language has special debugging aids for exam- 
ining immediate states. For example, BASIC has a STOP state- 
ment that you can insert at strategic points in the program. When 
the program arrives at a STOP statement, it pauses so that you 
can use BASIC'S immediate mode to examine variables, values, 
and so on. Use an immediate mode GO TO statement pointing to 
the appropriate line number to continue execution. 

FORTRAN IV has a special DEBUG statement indicator, a D in 
the first column of a statement line. Operations in statements 
marked with a D can perform useful debugging functions, such as 
printing intermediate results. You can treat such statements as 
source text (and thus execute them) or as comments (and thus 
ignore them), depending on whether you use a special compiler 
command option. In addition, FORTRAN IV has a traceback 
feature that locates the actual program unit and line number of a 
run-time error. If the program unit is a subroutine or function 
subprogram, the error handler traces back to the calling program 
unit and displays the name of that program unit and the line 
number where the call occurred. This process continues until the 
calling sequence has been traced back to a specific line number in 
the main program unit. Finally, FORTRAN IV has an optional 
interactive debugger called FDT (FORTRAN DEBUGGING 
TECHNIQUE) that can be linked with a user program. 

For MACRO-11 users, RT-11 provides a special on-line debug- 
ging tool called ODT (On-line Debugging Technique). This is 
provided as part of the RT-11 operating system and is an object 
program on your system volume. It is used exclusively for debug- 
ging assembled MACRO-11 programs. 

The use of ODT is described next for MACRO-11 users and for 
those FORTRAN IV users who will be combining MACRO and 
FORTRAN program code. Other users can continue to Chapter 
15, or go back and perform one of the other language demonstra- 
tions. Refer to the reading path outlined in the Preface. 
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Debugging a User Program 

USING THE 
ON-LINE 
DEBUGGING 
TECHNIQUE 



ODT is an interactive debugging tool that allows you to monitor 
program execution from the console terminal. ODT is provided as 
the object module ODT.OBJ on your system volume. To use it, 
you link ODT.OBJ with the assembled MACRO program that 
needs debugging. You then start execution of the resulting load 
module, not at the transfer address of your program, but at the 
entry point of the ODT module (shown on the linker load map as 
the global symbol O.ODT). Once ODT is started, you can use its 
special debugging commands to control the execution of your as- 
sembled machine language program from the console terminal, to 
examine memory locations, to change their contents, and to stop 
and continue program execution. 

The MACRO demonstration program in Chapter 11 still contains 
one error, which you can locate and correct using ODT. Several 
ODT debugging commands are demonstrated in the process. 

Throughout the examples in this chapter you need to refer to the 
program assembly listing that you produced in Chapter 11 (SUM) 
and stored on the storage volume. Print it now on either the 
terminal or line printer: 



Long Command Format 

(Line printer) 

. PRINTdB 

Files? UOLrSUM.LSTdl) 



(Terminal) 

.TYPE® 

Files? VOLiSUM.LBTdl) 



Short Command Format 

(Line printer) 

.PRINT MOLiSUM.LSTdl) 



(Terminal) 

.TYPE yOLjBUM.LST® 



SUH.HAC k'ERSIDN 1 



MACRO UO^.OO l2-DEC-aO 00:02I09 PAGE 1 



1 








.TfiLE 


SUM. MAC VERSION 


1 


2 
3 

4 








.MCALL 


.TTYOUFf ,1X11 


' 


PRINT 


5 
6 

7 


000106 






N 


/o 


;no. 


OF 


[iIIJlTS OF 'F- ro CAU:iJl-A[F 


8 






. 


'E' 


^. 


HE SUM Of IHt 


Rt:ci:pRO(:Ai,s of thi:. PiM^ttikJAL;:; 


10 






i 


1/0 


+ 


l/li ^ 1/2 1 f 


1-' 


31 + 1/4! i 1/51 f ... 


u 

12 000000 






exp: 


.PRINT 


•MESSAG 




fPRINT INTROnUCTORY lEXI 


13 000006 


012705 


000106 




MOV 




tNrRS 




fNO. Of CHARS Of 'E' TO fff 


14 000012 


012700 


000107 


FiRsr: 


HOV 




INHtRO 




tNO. ot- nir,iis OF accuracy 


15 000016 


012701 


000124' 




rtUV 




lArRI 




fADDREBIi LIP nil.ill VtCIOR 


16 000022 


006311 




secoNP 


ASL 




(»ftl 




iDCJ Mill r IPLY BY 10 ■nECJMA 


1? 000024 


011146 






Moy 




Wkl. vliiP) 




i^iAVP: *:■ 


16 000026 


006311 






ASL 




0R1 




S#4 


19 000030 


006311 






rtSl 




l?Hl 




i*a 


'^0 000032 


062621 






Aim 




i^Y') h. (h-1 ) 1- 




iNnu *io. POiNi III Nt.'.r fiL 


Jl 0000J1 


005300 






iii;t 




HO 




:Ar 1 Nil m luiH ib-" 


22 000036 


0013/1 






HNt 




SI UIJNli 




ifRANCH [F NGI 


23 000040 


012700 


000106 




MOV 




»N.K<> 




.(iU THRU ALl Kl.ADt';i. Lil'.'lH 


24 000044 


014103 




THIK-Ii: 


Moy 




-•.Hil ,KJi 




iBY IHb. FLAClsi INIH X 


25 000046 


012/02 


1///77 




MOV 




* I'll? 




ilNir [JllCMCIrNI K'btilSIMC 


26 000052 


005202 




FOUKTH 


INC 




R2 




SiiUMF liUlJT LENT 


2/ 000054 


160003 






BU& 




R0,K3 




iliUBFRnCr LOOP lliN I I'.Mi 


2B 000056 


103375 






yci: 




rijunrn 




iNIIMtiRi^rOR IS AllJAV'> lO*. 


29 000060 


060003 






Ann 




ro.r:) 




if IX KtMAINDFR 


30 000062 


0103U 






HHV 




fiJtPRl 




*(3AVb; REMAINDEF': Aii &AS [iL 


,il 
















iFlJR NFXr lUIUI 


32 000064 


06026 i 


177776 




ADD 




r:>. -2(ri ) 




fGREAIFSr INIEtif.R CAPKr.t'.i 


33 
















4 IK GlVt Ddiir 


34 0000/0 


005300 






nti: 




KO 




JAF FNli OF DKJll Uh i. f HP ' 


35 0000/2 


001364 






HNt 




rHi«ii 




JliRANCH IF NCIl 


36 000074 


014100 






MOV 




(KDtRO 




iGtn DIG£f T(.l MillPm 
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' 000102 

I 00010<1 

000110 

: 000114 

; 000114 

0001:^0 

00012:^ 



ii'.rvoo 00001:? 



oonoii 

00s, SOS 
00133-1 



17 oooi;ii 000107 



. ooo.ii;.' 

000.5-15 
COO.-JfiO 
00031^.53 
0003FiA 
O0O.JA1 

000:5^-1 



117 

lOS 

oi;* 



lOS 
106 

010 



srix tuf: :>./■ ri] .7 hq 

STHrtl IT I!3 ONLY 1 IJICUT 
?CRt:AL.r,Y IilVlUk BY 10) 
SMflKI;; mciT AEicri 
fOUrPLJT Tl-M- Diurr 

fCLEftR m:xT uiaiT locaiiun 

fMCIRt- niBITE rri F-KMNT''' 
f BRANCH IF ■l\.:S 
iUE f\RE DOME 



niR TO PiL,L (JNE;; 



i.JIIM.MAC yt;Rs:toN 1 



MACRO V04.00 

:?oo 



-iii;:r:-(io oo!02:o9 pagf:: i- 



HUM, MA 
HYdSUL 


TABLE 




MAKRO VO'l.OO 1 


A 


000l;MHi 
COOOOOR 




FIFTH 00007APi 
H'IRST 0000 laR 


. Any. 


000000 
000372 

nf.-TEi:TiE:D: 


000 
001 






2-riE:r>tto 00:02:09 pf\GE 1 ■■: 



yrh;TUAi. mE'MHRY uhed: biib udrub ( 33 f'fict::;5) 

liYNAMIC MtiMDRY AVA IL.ftOl.E l-OR S-Tt PflQF^S 



-uEt: 00 00! 02; 09 f-f\at: 



liXF' 


1-1 2t 


Klf'TH 


l~37t 


r-iF<si 


1-14* 


KOUKTH 


l~2At 


Mf-:fii:iAG 


1-12 


N 


1-7* 


HtrUHD 


l-l&t 


iiiJiRn 


1-21* 



liUH.MAC VE:Ri3I0N 1 MACRG yOl.OO 12- IKiiC EiO OOJOySO'? TAGE M- 

CkOSS REIFLFitLNCr:: TABLE (C;«ITF IJ04.00 ) 



.EXIT 


1-3* 


1—1 ::i 


.PRINT 


i-:i* 


1-12 


•TTYDU 


1 -3* 


1-11 



Now link the MACRO program object module (SUM. OBJ) stored 
on the storage volume (VOL:) with ODT.OBJ by using the /DE- 
BUG option, and print a load map directly on the terminal or line 
printer, choosing one of the following commands: 



LINK/DEBUG 



Long Command Format 

(Line printer) 



(Terminal) 



.LINK/MAP/DEBUGBI) 
Files? yOLsSUMlRET) 



.LINK/MAPsTTs/DEBUGElI) 
Files? MOLnSUMdl) 
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Short Command Format 

(Line printer) (Terminal) 

.LINK/MAP/DEBUG yOLrSUMilT) , L I NK / MAP : TT : / DEBUG yOL:SUMKB 

RT-11 LINK yOE.Ol Load Map Fri ll-Jan-80 i;);ll:26 

SUM .SAW Titles ODT Ident: yoa ■ 00 

Section Addr Size Global yalue Global WaUie Global Value 

. ABS. 000000 001000 ( RW , I ,GBL , ABS iGWR ) 

001000 000372 ( RW 1 1 iLCL iREL iCDN ) 

*DDT* 00137Z 00E152 ( RW , I ,LCL iREL .CON ) 

O.ODT 001E2a 

Transfer address = OOlBZa. Hi«h limit = 0075a2 = 19BS. words 



Look at the load map, and note that ODT starts at address 1372. 
The two modules together, ODT and SUM, reside in memory up 
to location 7542, the high limit. Look at the symbol table listing 
for the MACRO program. This shows that the program is 372 
(octal) bytes long and starts at location 1000. 

To load and start execution of the load module, use the monitor 
RUN command. The RUN command brings the entire load mod- 
ule, called SUM.SAV, into the absolute (physical) memory loca- 
tions shown in the load map and begins execution automatically 
at the starting, or transfer, address of the first module in mesmory, 
which is ODT. Type: 

Long and Short Command Format 

.RUN SUMiH) 

ODT U0<a.00 
* 

ODT prints an identifying message on the terminal and an aster- 
isk indicating that you are in ODT command mode and can enter 
an ODT command. You are now using ODT to control the execu- 
tion of your program.^ ODT commands let you execute the entire 
program or just portions of it, examine individual locations, ex- 
amine the contents of the PDP-11 general registers, and change 
the contents of any locations in your program you wish. If you 
make a mistake while you are typing any commands, type the 
DEL key; ODT responds with a ? and an asterisk, allowing you to 
enter another command. 



Be sure to read Chapter 16 of the RT-11 System User's Guide before you use 
ODT with any of your own programs. You must observe certain precautions 
when you write your program and when you load it with ODT. For example, 
you should make sure that ODT is not loaded into memory locations used by 
your program. There are steps you can take to prevent this from occurring. 
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(.TTYOUT), but that it occurs somewhere before location 110. So 
the next step in debugging this program is to set a breakpoint at 
some earlier point in the program logic and to rerun the program. 
You must restart ODT to do this. Return to monitor mode by 
typing CTRL/C. The remainder of the program message prints on 
the terminal; then the monitor period appears, indicating that 
you are in monitor mode: 

*@lL/C) 

ttVALUE OF E IS! 



Restart ODT and reset relocation register 0: 

.RUN SUMEED 

ODT uoa.oo 

* 1 ; R 

Set a breakpoint at location 76 (line 37 in the assembly listing), 
and start program execution at its beginning: 

* 1 7 B i B 

* 1 1 G 

TBO iO (000076 

Again, examine register to verify its contents: 

■*$0/000033ii5 

By following the program logic in the assembly listing, you know 
that the value in register should at this point be 33(octal) (2.7, 
previously multiplied by 10, = 27[decimal] = 33[octal]). So the 
value in register is correct. From this, you can deduce that the 
error must occur somewhere between locations 76 and 110. The 
proper step now is to check the assembly listing, where you find 
the error at line 40. The decimal point that should follow the 10, 
identifying it as a decimal 10, is missing. Therefore the program 
treats the 10 as an octal 10, or 8(decimal), making each digit in 
the result off by an additive factor of 2. The data in location 106, 
then, should be 72, not 70. Since this data has not yet been used, 
you can change it now with ODT and continue program execu- 
tion; if it had been used, you would need to restart ODT and then 
change the data. To change the contents of a location, simply 
open the location, type in the new contents, and close the loca- 
tion, using a carriage return. 

*0 tlOG/000070 72(11) 
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Now eliminate all breakpoints. 



IB 



Continue program execution; the correct results should print: 

*;p 

THE yflLUE OF E IS: 

Z.7 1SZ818Z8a590a52353BCl2B7471352GG2i|377572«7093Gggg5957a9BB9G7E2772a07GG 



SUMMARY: 
COMMANDS FOR 
DEBUGGING 
PROGRAMS 



To Start ODT 

LINK/DEBUG 

Link the assembled program (the program to be debugged) 
with the ODT object module. 

To Use ODTi 



© 



Close the currently open location and open the next sequential 
location for examination and possible modification. 



m 

Close the currently open location. 

addr/ 

Open the location indicated (addr) for examination and possi- 
ble modification. 

addr;G 

Begin program execution at the indicated address (addr). 



Continue program execution from a previous breakpoint. 

addr;nB 

Set one of the eight available breakpoints (n) at the indicated 
address (addr). 

;nB 



Cancel the indicated breakpoint (n). 



;B 

Cancel all breakpoints. 

addr;nR 

Set one of the eight available relocation registers (n) to the 
relocation constant value indicated by addr. 



Only a very few of the available debugging commands have been demonstrated 
in this chapter. Consult Chapter 21 of the RT-11 System User's Guide for all 
ODT commands. 



March 1981 



14-12 



Using the Foreground/ Background Monitor 



Long Command Format 



•LINK/FOREGROUND E) 
Files? DEMOFG m 



Short Command Format 

•LINK/FOREGROUND DEMOFG ES) 



Now you are ready to operate the two-job environment. Many 
times, you have to consider the devices that are used for output in 
a foreground/background environment. For example, if your pro- 
gram assumes that the output device is a Hne printer, and you do 
not have a line printer or you want to output to another device, 
use the ASSIGN command. Type this command in the following 
way, substituting the two-character code from Table 4-2 for the 
storage volume in place of xx. 



Executing The 

Foreground and 

Background Jobs 



Long Command Format 

.ASSIGN m 

Physical device ri a m e ? x k : (bet) 

Logical d e M i e n a (ii e : LP: lUll 

Short Command Format 

.ASSIGN xx: LP: (H 

You do not have to consider the above inforraation for the demon- 
stration programs that are provided, since the foreground job 
communicates with the background job, and both jobs send their 
output to the terminal. 



When you use the FB monitor, you must always load into memory 
the peripheral device handlers needed by the foreground job. You 
use the monitor LOAD command to make a device handler per- 
manently resident in memory. For example, if your foreground 
job requires the use of the line printer, you must load the LP 
device handler. You must specify the jobtype with the command. 
For a foreground job, the jobtype is F; for a background job, the 
jobtype is B. If you have assigned the code LP: to another device, 
the system automatically loads the assigned handler and you 
need not enter a LOAD command. If you are using the line 
printer, type: 



LOAD 



Long Command Format 



.LOAD m 
Deuice? LPs^ 
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Short Command Format 



.LOAD LP!=F m 



FRUN 



The command to load and start execution of the foreground job is 
FRUN, which is similar to the RUN command except that the 
system automatically loads and starts the execution of the fore- 
ground .REL program. You must use the /BUFFERm option with 
the FRUN command to execute a FORTRAN foreground job. The 
argument n represents, in octal, the number of words of memory 
to allocate. Use this command to start the execution of DE- 
MOFG.REL. 



Long and Short Command Format 



.FRUN/BUFFER:n DEMOFG m 

F> 

FOREGROUND DEMONSTRATION PROGRAM 

SENDS A MESSAGE TO THE BACKGROUND PROGRAM "DEMOBG" 

EMERY 2 SECONDS. TELLING IT TO RING THE BELL. 

B> 

The foreground program DEMOFG is now running and queuing 
the message for the background program every two seconds. You 
now execute the background program DEMOBG to allow it to 
receive the messages that were queued and to ring the bell. 



.RUN DEMOBG im) 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 



The bell rings several times in rapid succession as the monitor 
dequeues the messages, and then every two seconds as the fore- 
ground job sends its message to the background job. 

You can run other jobs in the background. You can use the back- 
ground of an FB environment in the same way as the SJ environ- 
ment. First, terminate the background job DEMOBG, using the 
double CTRL/C command. 



gfRL/C ) 
gfRiJC) 



Execute a DIRECTORY command in the background to get a 
listing of all the .OBJ files on the system volume by typing 

.DIRECTORY *.OBJ (13 
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To activate other bootstraps, set the numbers into the pushbut- 
tons, using the following method (if you make a mistake, push the 
button labeled CLR, then reenter the number): 

1. Push 1000 (read the number from left to right). 

2. Push LAD. 

3. Push the appropriate buttons for the first number in the 
Contents column (read the number from left to right). 

4. Push DEP; push CLR. 

5. Push the appropriate buttons for the next number in 
the Contents column (read the number from left to 
right). 

6. Repeat steps 4 and 5 until all numbers in the column 
have been used. 

7. Push 1000. 

8. Push LAD. 

9. Push the button labeled CNTRL, and, while holding it 
down, push the button labeled START. 

10. Continue to step 11 in Chapter 2. 



If your computer has a switch register console on the front panel 
similar to those shown in Figure A-2, you can use the switches to 
manually give the computer the bootstrapping information it 
needs to start the system. 



USING A SWITCH 

REGISTER 

CONSOLE TO 

BOOTSTRAP 





Figure A-2 Switch Register C!?onsoles 

Several switches on the console are spring-loaded. This means 
that the switch moves in only one direction and returns to its 
initial position after you use it. You must set the remaining 
switches either up or down as instructed. 
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The bootstrap for your RT-11 computer system consists of a series 
of six-digit numbers that you must load into the computer using 
the switch register console. First, obtain the bootstrap of your 
system device from the RT~11 Installation and System Genera- 
tion Guide, and copy the numbers into the space provided below. 
If your system has a hardware bootstrap, "^ the bootstrap consists 
of only two numbers, which you should copy into the left-hand 
space; otherwise, the bootstrap consists of two columns of num- 
bers labeled Location and Contents, which you should copy into 
the right-hand space: 



Hardware Bootstrap 

Load Address = 
Start Address = 



Other Bootstraps 



Next, convert the numbers in the column to binary numbers, 
using the conversion process shown in Table A-1. 

Table A-1: Binary Conversion 



Octal 




Binary 








000 


1 


= 


001 


2 


= 


010 


3 


= 


oil 


4 


= 


100 


5 


= 


101 


6 


= 


no 


7 


= 


111 



For example, the number 173100 is converted to 001 111 Oil 001 
000 000. You set this 18-digit binary number into the switch regis- 
ter by placing each individual switch in an up position for a 1 or a 
down position for a 0. The number 173100 is set into the switch 
register as follows: 

lit ttt itt Ut Hi Hi 

The number 012700 is converted to 000 001 010 111 000 000 and 
is set into the switch register as follows: 

Hi lit 4ti ttt Hi Hi 



A hardware bootstrap is bootstrapping information that is already in compiuter 
memory but that you must activate by entering a load address and a start 
address, each a six-digit number. 
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